home *** CD-ROM | disk | FTP | other *** search
/ Hyper Stacks 1994 May / Hyper Stacks (Pacific HiTech)(1994)[Mac].iso / HyperTalk / Serial Port Toolkit v.2.5 / Serial Port XCMD Docs / card_10271.txt < prev    next >
Encoding:
Text File  |  1988-05-10  |  1.2 KB  |  35 lines
  1. -- card: 10271 from stack: in
  2. -- bmap block id: 0
  3. -- flags: 0000
  4. -- background id: 3170
  5. -- name: 
  6.  
  7.  
  8. -- part contents for background part 9
  9. ----- text -----
  10. Function:
  11.  
  12. -- part contents for background part 1
  13. ----- text -----
  14. recvUpTo(termChar,timeOut,oldString)
  15.  
  16. -- part contents for background part 2
  17. ----- text -----
  18. Receive characters from the port.
  19.  
  20. -- part contents for background part 3
  21. ----- text -----
  22. termChar
  23.  
  24. timeOut
  25. oldString
  26.  
  27. -- part contents for background part 7
  28. ----- text -----
  29. character after which to terminate the receive, or empty if any characters up to the time-out are to be read.
  30. number of ticks (1/60ths of a second) to wait, or zero.
  31. string of previously received characters.
  32.  
  33. -- part contents for background part 4
  34. ----- text -----
  35. This is the principle, and most powerfull receive character function. It inputs character until a particular character is received or until a time-out occurs. It will echo and edit input if those features have been enabled with the configureSPort command. If editing is enabled, backspacing is allowed not only on new input, but also on previous input, which should be passed to the function in the oldString paramter. recvUpTo returns both the old string and any new input.